home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 480 / applic / address.doc < prev    next >
Text File  |  1990-07-20  |  8KB  |  187 lines
  1.                         STreet finder 1.0
  2.                             Written by
  3.                           John Buchanan
  4.                      Dept of Computer Science
  5.                       University of Toronto
  6.                          Toronto, Ontario
  7.                              M5S 1A4
  8.  
  9.                     This program is shareware
  10.                 If you like it a lot then send me
  11.                             some money
  12.  
  13.  
  14.  
  15.      Introduction
  16.  
  17.      STreet finder is an address book that was developed with  the 
  18. user  interface  in mind.   In fact the  interface  was  completed 
  19. before the program had the ability to handle any  addresses.   The 
  20. idea was to simulate an address book.   Notice that address  books 
  21. are  extremely user friendly.   When was the last time  that  your 
  22. address book told you that you entered a wrong entry into it? 
  23.  
  24.      STreet  finder  incorporates a feature that is not  found  in 
  25. ordinary address books.   If the first character in the name field 
  26. is not the same as the current page then a cross referenced  entry 
  27. can be seen on the appropriate page.
  28.  
  29.      i.e.   If John Buchanan appears in the name field of an entry 
  30. in page B then this entry can be seen on Page J
  31.  
  32.      Pages for particular letters are accessed by either  clicking 
  33. the  mouse in the appropriate chicklet (Rectangle with the  letter 
  34. in it) or by depressing the appropriate key on the keyboard.
  35.  
  36.      When the book is opened there are several things that must be 
  37. noticed.
  38.  
  39. 1)     The  current  page is indicated by  highlighting  the  page 
  40.        chicklet.   Also there is a superscript above the letter in 
  41.        the  highlighted chicklet.  This indicates the page  number        
  42.        for the current letter.  i.e. a letter can have more than 8        
  43.        entries.
  44.  
  45. 2)     On  the right hand side of the new command line  there  are 
  46.        two chicklets with a left arrow and a right arrow in  them.  
  47.        With  these chicklets you can flip through the  book.   The 
  48.        above action can also be accomplished by using the left and 
  49.        right arrows on the key board.
  50.  
  51. 3)     On  the  left hand side of the command line there  are  two 
  52.        commands.
  53.  
  54.        Insert  This inserts a new address blank at the end of  the 
  55.                current page.  (before any cross referenced entries 
  56.                for  this page)  This can also be  accomplished  by 
  57.                using the insert key on the keyboard.
  58.  
  59.        Delete  This places you in delete mode.   The mouse  cursor 
  60.                says  DELETE  in it and you have to  point  at  the 
  61.                address that you want to delete.  If you point at a 
  62.                valid  address an alert box comes up asking you  if 
  63.                you  are sure that you want to delete the  address.  
  64.                If  you point at an invalid address you  will  exit 
  65.                delete  mode.   You  can enter the delete  mode  by 
  66.                using the delete key on the keyboard.
  67.  
  68. 4)     CLOSE.   This  simply closes the book  and  redisplays  the 
  69.                 cover of the box. This can also  be done using the
  70.                 Clr Home key
  71.  
  72.  
  73. 5)    You are wondering how to edit an address field.
  74.  
  75.        In  order to edit point at the address field that you  want 
  76. to edit.  A cursor appears at the end of the line that you pointed 
  77. at  and the mouse cursor now says edit.   ( There is a slight  bug 
  78. here.  If  you point at the line between two entries in a  address 
  79. field the cursor says edit but no editing cursor  appears.  Simply 
  80. point the cross that is now on the mouse cursor at the entry  that 
  81. you want to edit.)  
  82.  
  83.      Because  of  the cross referencing feature you can  edit  all 
  84. entries in a cross referenced address exept the name.  If you want 
  85. to edit the name you must edit the original entry.  (as you change 
  86. the first letter its cross reference will move from page to page.)
  87.  
  88.  
  89. EDIT MODE key interpretation
  90.        
  91.        Left Arrow        Move  edit cursor one  character  to  the 
  92.                          left.
  93.  
  94.        Right Arrow       Move  edit  cursor one character  to  the 
  95.                          right.
  96.  
  97.        Up Arrow          Move to previous entry in address field.
  98.  
  99.        Down Arrow        Move to next entry in the address field.
  100.  
  101.        Shift Left Arrow  Move to the beginning of current entry.
  102.  
  103.        Shift Right Arrow Move to the end of current entry.
  104.  
  105.        Alphabetical/
  106.        Numerical/
  107.        Shifted  Numeric  Insert into the current entry.
  108.  
  109.  
  110. 8)     ending the program or exiting the desk accesory
  111.  
  112.      Clicking  in the upper left close box will cause you to  exit 
  113. the address book.  If you have edited any address then you will be 
  114. asked  wether  you want to save the changes.   If you  say  no  an 
  115. internal flag is set and you will not be prompted again.
  116.  
  117.       Also My disk i/o is not to intelligent so I have not  figured 
  118. out what to do with empty files so if you atempt to save an  empty 
  119. book  I  have made it so that it saves my address.   If  you  have 
  120. another address in the book you can delete my address and be  done 
  121. with me.
  122.  
  123. 8b)  File format
  124.  
  125.      All data is stored in stfind.dat which has to  be on the root 
  126. directory of the a: drive (I will allow this to change later on).
  127. The Data is stored in ascii format.  Not terribly eficient but one 
  128. of  my main beefs against all the other address book  managers  is 
  129. that it is hard to access the data.  
  130.  
  131. each address line fits on one line of the output file.
  132.  
  133. For example John Buchanan
  134.             tel1            tel2
  135.             line1
  136.             line2
  137.             line3             code
  138.           on page B
  139. is stored
  140. B<cr>
  141. John Buchanan<cr>
  142. tel1<cr>
  143. tel2<cr>
  144. line1<>cr> ... and so on. you get the idea
  145.  
  146. 7)     PRINT
  147.        This is something that I've just started playing with.   It 
  148. is only accessible from the program.   I assumed that printing out 
  149. 26+  pages of stuff is not something that you will want to do  all 
  150. the  time.   Right now it just prints out all the pages  that  are 
  151. required.  >=27  One  for the tile page.   What you do  with  this 
  152. output  is to cut all the pages at the dotted line and fold  each 
  153. page  so that the addresses are on the outside of  the  page.  Now 
  154. staple all the pages together in order to form a little  booklet. 
  155. Voilà you have a little address book.   In six months print out an 
  156. updated one.  I do not claim that this part of the program is very 
  157. clean.   (I  have  a Roland 1011) printer which I  think  is  100% 
  158. compatible  with   an Epson LX-80 printer.   In the  next  version  
  159. (May)  I  Hope  to have a better interface to  this  part  of  the 
  160. program.
  161.      
  162.  
  163.      I have developed two versions of the program.   One is a Desk 
  164. accessory and the other is a program.   I read somewhere that a DA 
  165. could not dynamically allocate memory,  this forced me to  develop 
  166. different data structure management schemes.   The DA will only let 
  167. you 10 new addresses per session.  The program allow you to add as 
  168. many as you want in one session.
  169.  
  170.      The  DA runs best if you close the window before you  exit  a 
  171. particular application.
  172.  
  173. I hope that this is useful.   I find it very useful and I have had 
  174. a lot of fun developing it.   I don't think that I'd be willing to 
  175. let the source code float around right now.  I want to retain some 
  176. control  on  this for now.   Maybe even get it to run on  a  color 
  177. monitor   ( Probability ~=0) some day.   
  178.  
  179. I'm  In  the process of finishing my course  requirements  for  my 
  180. masters so don't expect any immediate updates.  
  181.  
  182. Enjoy
  183.  
  184.  
  185. Pardon the hacked up documentation above.   It is midnight after a 
  186. long day.
  187.